.TH std::basic_streambuf::sgetc 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::basic_streambuf::sgetc \- std::basic_streambuf::sgetc

.SH Synopsis
   int_type sgetc();

   Reads one character from the input sequence.

   If the input sequence read position is not available, returns underflow(). Otherwise
   returns Traits::to_int_type(*gptr()).

.SH Parameters

   \fI(none)\fP

.SH Return value

   The value of the character pointed to by the get pointer.

.SH Example


// Run this code

 #include <iostream>
 #include <sstream>

 int main()
 {
     std::stringstream stream("Hello, world");
     std::cout << "sgetc() returned '" << (char)stream.rdbuf()->sgetc() << "'\\n";
     std::cout << "peek() returned '" << (char)stream.peek() << "'\\n";
     std::cout << "get() returned '" << (char)stream.get() << "'\\n";
 }

.SH Output:

 sgetc() returned 'H'
 peek() returned 'H'
 get() returned 'H'

.SH See also

   sbumpc             reads one character from the input sequence and advances the
   stossc             sequence
   (removed in C++17) \fI(public member function)\fP
                      advances the input sequence, then reads one character without
   snextc             advancing again
                      \fI(public member function)\fP
